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LU We will show how to build a low-cost LoRa 
gateway fo collect data from end-devices 


LI The device part will be shown in a separate 
tutorial 


LI The hardware platform is a Raspberry PI. RPI 
v1&2 have been successfully tested 


LI Let’s get started... 
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ASSEMBLING THE HARDWARE 


Respberry Pi Medel B+ V1.2 
@©fospberry Pi 2014 


as eas cise 
Raspberry Pi/ 2 Medel BM SES 
© Raspberry Pi 2014 


or ehh a ras 


NAZILE 


=—TOW THE RADIO MODULE (2) 
(WAZILE» 


bia 

ad a wi 

OPERF - 
ro, # ELECTORNIC 


3 rs ad rs " : a 
D103 BICEgO1s). at fh 


PTT Tt 


If you take the HopeRF RFM 92W/95W you will need 
the adaptor breakout and you have to go though some 
delicate but simple soldering tasks! It is not difficult but 
you have to trained a bit before! Then, like for the 
inAir9, use F/F breadboard cable to connect the SPI 
pins, using different colors as explained previously. 


GPIO#  2ndfunc. | Pin#| Pin#) 2nd func. GPIO# 


+3.3V 1 v2 +5 V 
2 SDAI (I2C) [a] WW asv 
3 SCL1 (12C) 6 | GND 


4 GCLK a TXDO (UART) | 14 
GND ie | RXDO (UART) | 15 


17 GENO GEN1 18 
27 GEN2 
22 GEN3 15 


43.3V 17 18 GENS 24 
10 MOSI (SPI)|_ 19 20 ND 


9 MISO (SPI)| 24 BAR sens 25 


11 SCLK (SPI)||28 24 |CEO_N (SPI) | 8 
Ty | : GND El 26 CEI_N(SPI) 7 
© Raspberry: Pi + 
3 (RPi 1 Models A and B stop here) 
EEPROM | ID_SD 27) (Ben iD_sc EEPROM 
eons 1 
saul date 5 N/A En GND 
= RG divans” f, 
6 N/A 12 
13 N/A {s3) | 34 [ene 


19 N/A 


26 N/A 37 38 Digital IN 20 
GND 33 | 40 Digital OUT | 21 


GPIO# 
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1 


EEPROM 


Pin# 


2nd func. Pin# | 2nd func. 


43.3V | 8 PF 


SDAt (I2C) |: Dy sv 


SCL1 (12) GND 
GCLK “TXDO (UART) 
GND _RXDO (UART) 
GENO. GEN1 
GEN2 GND 
GEN3 GEN4 
+3.3 V Alt/ GEN5 
most (sP)||19 GND 
MISO (SPI)|| 24 GENG6 


SCLK (SPI)| 23 [24 | CEO_N (SPI) 


GND 25 | l26  CEI_N (SPI) 


(RPi 1 Models A and B stop here) 
ID_SD 27 28 ~=|ID_SC 


N/A GND 
N/A 

N/A GND 
N/A N/A 


N/A 38 Digital IN 


GND 39 | 40 Digital OUT 


EEPROM 
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GETTING, COMPILING & 
INSTALLING THE SOFTWARE 


re 
RaspbianOS 
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. INSTALLING THE OS 
(WAZILE» 


8.0 


RaspbianOS 


We use the Raspbian OS. Install it on an SD card. There are many tutorials on the Internet for 
such procedure. Alternatively, we can provide the full image to burn on the SD card. It’s 8GB! 


TTING THE LORA SPECIFIC 


(WAZILE) GW SOFTWARE 


Branch: mastery LowCostLoRaGw / Raspberry / 


CongducPham / LowCostLoRaGw © Watch 


<> Code Issues 6 Pull requests 0 Pulse Graphs 


Low-cost LoRa gateway with SX1272 and Raspberry 


© 11 commits by 1 branch © O releases 


Branch: master ~ New file Find file HTTPS ~_https://github.com/Cd 


Congduc Pham modified some low-power info 


fie Arduino modified some low-power info 
fim Raspberry modified some low-power info 
=) .DS_Store changes in the SX1272 lib, gateway and temperature example 
=) README.md modified some low-power info 


mkdir lora_gateway 


Congduc Pham modified some low-power info 


i) 


.DS_Store modified some low-power info 


SX1272.cpp Added Teensy support 


iu) 


$X1272.h Added Teensy support 


arduPi.cpp First commit 


arduPi.h changes in the SX1272 lib, gateway and temperature example 


arduPi_pi2.cpp First commit 


arduPi_pi2.h First commit 


bem2835.h First commit 
log_gw.py change python scripts name 
lora_gateway.cpp modified some low-power info 


makefile modified some low-power info 


post_processing_gw.py added some low-power info 


786i mm  fM 1} mm fy 1} 1D} 


radio.makefile changes in the SX1272 lib to get SNR in ACK packet 


git clone https://github.com/CongducPham/LowCostLoRaGw. git 


cp LowCostLoRaGw/Raspberry/* lora_gateway/ 


Log in the RPI (ssh) and create a directory called lora_gateway. Get the LoRa RPI library from 
our github: https://github.com/CongducPham/LowCostLoRaGw (right) then copy all the files of the 
github’s Raspberry folder into the lora_gateway folder. 


> cd lora_gateway 
> make lora_gateway 


g++ 
g++ 
g++ 
g++ 


-DRASPBERRY -DIS RCV GATEWAY -c lora_gateway.cpp -o lora_gateway.o 
-c arduPi.cpp -o arduPi.o 
-c SX1272.cpp -o SX1272.0 


-lrt -lpthread lora_gateway.o arduPi.o SX1272.0 -o lora_gateway 
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mm UR LOW-COST GATEWAY 
(WAZIUE ARCHITECTURE 


Most of user or 
Kept as simple application specific 
as | logics is done here! 
We provide some 
basic features, up to 
you to enhance them 
©: 


stdout stdout 


bridge 
program stdin 


+O 
RaspbianOS 


14 


T=23° 
@ 
Node 10 


> sudo ./lora_gateway 

Power ON: state 0 

LoRa mode: 4 

Setting mode: state 0 

Channel CH_10 868: state 0 

Power M: state 0 

Get Preamble Length: state 0 

Preamble Length: 8 

LoRa addr 1 : state 0 

$X1272/76 configured as LR-BS. Waiting RF input for transparent RF-serial bridge 


--- rxlora. dst=1 type=0x10 src=10 seq=0 len=5 SNR=9 RSSIpkt=-54 
“p1,16,10,0,5,9,-54 
T=23° 


--- rxlora. dst=1 type=0x10 src=3 seq=0 len=5 SNR=8 RSSIpkt=-54 
“p1,16,3,0,5,8,-54 
H=85% 
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NAZILE 


| #define DEFAULT_DEST_ADDR 1 
| #define LORAMODE 4 


#define node_addr 6 


\!##18.5 
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> sudo ./lora_gateway | python ./post processing gw.py 
Power ON: state 0 


LoRa mode: 4 All lines that are not prefixed by specific 


Setting mode: state 0 character sequence are displayed 

Channel CH_10 868: state 0 oo unchanged 

Power M: state 0 

Get Preamble Length: state 0 

Preamble Length: 8 

LoRa addr 1 : state 0 

$X1272/76 configured as LR-BS. Waiting RF input for transparent RF-serial bridge 


--- rxlora. dst=1 type=0x10 src=10 seq=0 len=5 SNR=9 RSSIpkt=-54 
p1,16 mY 0,5,9 ad 


provides information on the last received 


(ase=t ¢ type= 0x10 arc 10 seq=0 len=5 SNR=9 RSSI=-5 packet: dst, type, src, seq, len, SNR & RSSI 


--- rxlora. dst=1 type=0x10 src=3 seq=0 len=5 SNI 
*pl,16,3,0,5,8 —54 


a o 1,16,3,0,5,8,-54 
(dat= 1 type=0x10 src=3 seq=0 len=5 SNR=8 RSSI=-54) 
H=85% 
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GATEWAY TO CLOUD 
WWAZILE» 


~ Dropbox 


S Firebase 


[ame] 


= = Fooenee 2 
= © GroveStreams 
GD SensorCloud’ 


Data received at the gateway can be pushed to loT clouds. We provide python script examples for 
many loT cloud platforms. Most of clouds with REST API can be easily integrated. 


T=23° 
@ 
Node 10 


> sudo ./lora_gateway | python ./post_ processing gw.py 

Power ON: state 0 

LoRa mode: 4 

Setting mode: state 0 

Channel CH_10 868: state 0 

Power M: state 0 or \& before the data indicates that the 
Get Preamble Length: state 0 data should be logged on a file or server. It is 


Preamble Length: 8 up to the end-device to decide which option 


LoRa addr 1 : state 0 
SX1272/76 configured as LR-BS. Waitivig RF input for transparent RF-serial bridge 


--- rxlora. dst=1 type=0x10 c=10 seq=0 len=5 SNR=9 RSSIpkt=-54 
Rev ctrl packet info 1,1 0,0,5,9,-54 
dst= =0x10 = seq=0 len=5 SNR=9 RSSI=-54) 
=1 type=0x10 src=3 seq=0 len=5 SNR=8 RSSIpkt=-54 
Rev ctrl packet info 1,16,3,0,5,8,-54 


dst=1 type=0x10 src=3 seq=0 len=5 SNR=8 RSSI=-54) 
rcv msg to log (\&)|/on firebase : H=85% 


ii USING 


(WAZILE» Dropbox 


LI A message starting with '\$’ is logged in a file 
‘telemetry.log’ in a folder shared through 
Dropbox 


(src=10 seg=0 len=5 SNR=9 RSSI=-54) 2015-11-04T10:14:30.328413> T=23° 
(src=10 seg=1l len=7 SNR=8 RSSI=-54) 2015-11-04T10:14:37.443350> T=23.2° 
(src=10 seq=2 len=5 SNR=8 RSSI=-53) 2015-11-04T10:16:23.343657> T=24° 


\ 
\ 
\ 


SL Be \. 
oe. © 


Node 10 
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a USING & Firebase 
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LI A message starting with '\&’ is logged in a 
Firebase database 


Dashboard _ ViEWINGMYFIRST APP Account Settings 


Legend 
i l™ Changed 
=~ LoRa Hl Added 
=| LIUPPA @ Deleted 
= MH Moved 


—_ RPigateway 
=} 2015-11-04 


=) sensors 


: =| msgO 
@ ips om RSSK: -54 


iene SNR: 8 
Node 3 
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Ore} ThingSpeak 
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LA message starting with '\!' is logged in a 
ThingSpeak channel See —~ 


Test LoRa UPPA 


Channel ID: 66583 Test of LoRa gateway at University of Pau, France 
Author: cpham ©: Test, lora, uppa 
Access: Public 


Account Sign Out 


Private View  PublicView —ChannelSettings  APIKeys —_Data Import / Export 


Ea [ h ] n g S @ e rs | k @ Add Visualizations Data Export MATLAB Analysis: MATLAB Visualization More Apps 


Test LoRa UPPA Test LoRa UPPA 


oe ThingSpeak Channels ~ Apps Blog Support ~ 


= 09:34 09:35 09:36 09:37 09:38 09:34 09:35 09:36 09:37 09:38 
User: cpham me 


ThingSpeak.com ThingSpeak.com 


l Test LoRa UPPA 


Test LoRa UPPA 


Channel ID: 66583 
Author: cpham 


Test of LoRa gateway at ae re 
University of Pau, France Date 


ThingSpeak.com ThingSpeak.com 


Field 5 Chart e x Field 6 Chart ernx 


Test LoRa UPPA Test LoRa UPPA 


® Test, lora, uppa 


ss 
09:35 09:36 09:37 09:38 09:34 
Date 


09:35 


pip 


ai USING @FIWARE CLOUD 
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LJ FIWARE support has been added with EGM script 


A non-intrusive approach is required 


" Capable to integrate with existing or future systems dealing with 
management of municipal services without impact in their architectures 


© Info about attributes of one entity may come from different systems, 
which work either as Context Producers or Context P’ 


Connecting to the Internet of Things 


© Applications rely on a single model adapting to syste 


Application/Service 


© Capturing data from, or Acting upon, loT devices should be as easy 
as to read/change the value of attributes linked to context entities 


GET <Oauth token> 
N2/entities/lamp1/attrs/presenceS ensor 


PUT <Oauth token> 


NGSI API Integration with sensor networks 


Context Producer ~— x " FIWARE NGSI is capable to deal with the wide variety of loT protocols today 


_ " Rather than trying to solve the battle of standards at loT level, it brings a 
; standard where no standard exists today: context information management 
Figures from FIWARE Y 9 


Issuing a get operation on the 
“presenceSensor" attribute 

enables the application to get 
info about presence of people 
near the lamp 


create/monitor loT Agent 
Manager 


FIWARE Backend loT 
Device Management 


(southbound interfaces) 


ETSIM2M_—MQTT__---+ IETFCoAP 


freeboard DATASOURCES 


MyDevice 


“f ADD PANE 
A fiware testing of sensors 
START TUTORIAL 


fiware testing of sensor10 


ADD 


@Revenir a Mail 10:12 (Zz @Revenir a Mail 10:12 
a thingspeak.com 


CJ ThingSpeak 


Field 1 Chart ? 


Temp for sensor 3 


a freeboard.io 


T from sensor 3 (office):22.94 
Fri Dec 04 2015 
10:10:32 GMT+0100 


T from sensor 3 (office) 


03:00 06:00 
Date 


Field 2 Chart 


Temp for sensor 10 


N 


8 


09:00 


T from sensor 10 (window) 


Field 5 Chart 


sinc &D SensorCloud’ 
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GD SensorCloud” DEVICES ACCOUNT CSV UPLOADER DATA SETTINGS MATHENGINE® USE JS VIEWER congduc.pham@univ-pau.fr LOG OUT 
liuppa_sensors Clear Download | Share |{ al Data |x] Last Upload: 3 hours 36 minutes 
Sensor | Channel Graph Zoom: 10s 1m 5m 10: ith id iw 1M-~=— max Timezone: _L: Central European 
sensor3 temp LJ 25.4 
Hide L id 
sensor6 temp 4) peed 
@ sensor6 - temp 
25.2 
25 
24.8 
24.6 
24.4 
— \ 24.2 
Metadata Focus 
24 
23:8: 
23.6 


14:30 14:33 14:36 14:40 14:43 14:46 14:50 14:53 14:56 15:00 15:03 15:06 15:10 15:13 15:16 15:20 15:23 15:26 


12/13/15 14:28 (Hl+| +) mane (=| 12/13/15 15:29 


(12/11/15 8:33 12/13/15 15:29 25 
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USING 


») GroveStreams 


DO Og fpr... @ MicroStr... [Ei] freeboard / =m Obse... x \€) tftelkam... | ATmega328P... | Sp SX1272... | SMAouRP-S... $$ Top 49T... iP +» € 


(€) @ https: //www.grovestreams.com/observationStudio.html?org=7a5de802-5d71-319 


yria Utne 


Cc (Q ligue aquitaine tir 


Les plus visités ~ | Débuter avec Fire... Alaune ~ 


o GroveStreams 


University of Pau Congduc Pham ~ 


Component Studio  Adminy | $$ [4 (0,6,0) e (2) 


Observation Studio «), | em sensor6 *|| am sensor3 | 
| @Components || i. Dashboards LI | = Doe : z 
Components ah) 2)@) © *none*~ From: 2015-12-14 (3 20:26:12 To: 2015-12-14 9) 22:26:04 |v) IM 4 DL) Compare Data Points 
4 J Components temp | 
4B sensor3 id © i Oxd © delete 26.00 
«= temp ‘Row! | Time > “Value 
ebm 1 @ 22:26:03.633 25.87 
2 @ 22:23:40.604 25.87 24.00 
3 @ 22:21:35.489 25.87 
4 @ 22:17:32.907 25.87 
5 @ 22:15:41.998 25.87 
6 @ 22:11:40.452 23.43 se00 
7 @ 22:07:36.184 23.43 
8 @ 22:03:33.273 22.94 20:30 21:15 22:00 22:30 
« 9 @ 21:59:33.532 23.43 
10 @ 21:55:28,121 23.92 
11 @ = 21:51:22.015 22.94 
12 @ 21:47:22.836 23.92 
13 @ 21:45:17.126 23.92 
14 @ 21:41:13.750 22.94 
Quick View ¥\x 
temp 25.87 
Last updated 22:27:57 (3m 59s ago) 22:27:57 
25.00 ST _ YY” 
20:45 21:00 21:15 21:30 21:45 22:00 22:15 22:25 
Refresh 
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. ADD A NEW CLOUD 
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if (ch=='\\'): 
now = datetime.datetime.now() 


if _validappkey==1: 
print 'valid app key: accept data' 


ch=sys.stdin.read(1) 


if (ch=='$'): #log on Dropbox 


data = sys.stdin.readline() 

print "rev msg to log (\$) on dropbox: "+data, 
f=open(os.path.expanduser(_telemetrylog_ filename),"a") 
f.write(info_strt+' ') 

now = datetime.datetime.now() 
f.write(now.isoformat()+'> ') 

£.write(data) 

£.close() 


elif (ch=='&' and _firebase==1): #log on Firebase 


data = sys.stdin.readline() 
print 'rev msg to log (\&) on firebase: '+data, 
now = datetime.datetime.now() 
firebase_msg = { 
‘dst':dst, 


Add your own data prefix or replace the default one with your own cloud parameters 


sensor _entry='sensor%d'% (src) 
msg_entry='msg%d' % (seq) 
date_entry=now.date() 


db entry = _dbpathtdate_entry.isoformat()+'/'+sensor_entry 
result = _db.put(db_entry, msg_entry, firebase_msg) 
elif (ch=='!' and _thingspeak==1): #log on ThingSpeak 


Zi 


pie o 2 0 
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STANDALONE GATEWAY 


28 


NNING WITHOUT INTERNET 
ACCESS 


92.168.200.1 


Access to the data from MongoDB 


Ww jQuery 


write less, do more. 


Display data: © lwO thO hu te® Tc 


Display sources: node_1 node_8 


(4 Bluetooth_raspi 


(1 Bluetooth_raspi 


{J Bluetooth_raspi 


1 DATE: 2016-05-09 08:04:59.807000 DATA: {"Iw’: 
3.29, "th’: 22.6, "hu": 50.7} 
NODE: 1 DATE: 2016-05-09 08:28:52.993000 DATA: {"Iw": 
3.29, “th’: 22.89, "hu: 50.29} 1 Ca 
1 DATE: 2016-05-09 08:53:04.317000 DATA: {"Iw": check to retrieve its data 
3.29, *th’: 23.2, "hu": 50.79} 
NODE: 1 DATE: 2016-05-09 09:05:00.997000 DATA: {'Iw’: 
3.29, “th”: 23.29, “hu*: 51.29} 8 oO 
NODE: 1 DATE: 2016-05-09 09:17:24.482000 DATA: {'Iw’: check to retrieve its data 
3.29, th’: 23.39, “hu: 51.7} 
NODE: 1 DATE: 2016-05-09 09:41:27.437000 DATA: {"Iw’: DATES PREFERENCES 
3.29, "th’: 23.6, "hu": 52.0} 
NODE: 1 DATE: 2016-05-09 10:05:39.032000 DATA: {"Iw": . . 
3.29, "th’: 23.79, "hu": 51.5} Pick a begin date 


DE: ERE! Creating .csv file with the data received... 
ee eee File 17-05-2016_10h39m36s.csv created and saved in the 
folder /storage/emulated/0/Raspberry_local_data 


NODE: 1 DATE: 2016-05-09 10:17:45.186000 DATA: {"Iw": Retrieve data since 09-05-2016 
3.29, “th’: 23.79, "hu": 50.79} 

NODE: 1 DATE: 2016-05-09 10:29:24.285000 DATA: {"lw": 4 

3.29, "th’: 23.79, hu": 50.79) Pick an end date 

NODE: 1 DATE: 2016-05-09 10:53:09.347000 DATA: {"Iw’: Retrieve data until 17-05-2016 


3.29, “th: 23.79, “hu”: 51.9} 
NODE: 1 DATE: 2016-05-09 11:17:02.953000 DATA: {"Iw’: 
3.29, “th”: 23.5, "hu": 50.79} 
NODE: 1 DATE: 2016-05-09 11:52:53.334000 DATA: {"Iw": 
3.29, "th": 23.29, "hu": 50.7} 
NODE: 1 DATE: 2016-05-09 12:04:32.437000 DATA: {"lw": 
3.29, “th”: 23.5, "hu": 50.29} 
NODE: 1 DATE: 2016-05-09 12:16:56.116000 DATA: {"Iw’: 


2.90 "th" 92 6 "hi 6M 201 


- Retrieve data ina ‘ Retrieve data in a 
Display data Sane Display data csv file 


a 8) o) 


